1
Markdown 首要哲學與核心架構原則
EvoClass-AI007第 1 課
00:00

OpenClaw 基礎

1. Markdown 首要哲學

OpenClaw 將人類可讀的文件視為絕對的真理來源。與將邏輯埋藏於資料庫的系統不同,代理的「靈魂」定義於文字檔案中,確保了 透明性與簡單的 版本控制

  • SOUL.md: 定義角色與道德界線。
  • AGENTS.md: 概述工程工作流程。
  • MEMORY.md: 儲存長期事實與偏好。

2. 模型無關且自主

中央化的代理執行環境允許在不重寫邏輯的情況下切換 LLM(Claude、GPT、本地模型)。自主代理透過 HEARTBEAT.md 排程器全天候運作。

3. 可靠性與資料完整性

為防止在高併發環境中出現 狀態損毀,OpenClaw 使用 會話隔離 透過通道佇列實現。資料檢索由 本地優先 RAG 架構透過語義快照處理。

設定:openclaw.json
{ "global": { "port": 18789, "identity": "./config/SOUL.md", "env_injection": true }, "security": { "firewall": "strict", "rce_protection": true } }
輸入指令...
問題 1
為什麼 OpenClaw 偏好「Markdown 首要」的方法?
為了提升 LLM 的執行速度。
為了確保透明性與人類可讀性。
為了完全取代 JSON 檔案的需求。
問題 2
在多用戶同時互動時,什麼能防止「狀態損毀」?
本地優先 RAG
語義快照
透過通道佇列的會話隔離
挑戰:除錯者
診斷遺失的代理行為。
問題: 代理已部署,但它回應的是通用人格而非指定角色,且無法回憶昨天會話的資料。
分析
哪些檔案或組件可能設定錯誤?
診斷:
1. 角色問題: 檢查 SOUL.md,並確認其在 openclaw.json
2. 記憶問題: 確認 MEMORY.md 可寫入,且 本地優先 RAG 系統能成功建立語義快照。